---
title: 发布流程
description: Learn how we version and release the SDK and recent changes.
---

## 版本管理

本项目遵循稍作修改的语义化版本管理，形式为 `0.Y.Z`。前导的 `0` 表示 SDK 仍在快速演进。各组成部分的递增规则如下：

## 次版本号（`Y`）

对于未标记为 beta 的任何公共接口出现的**破坏性变更**，我们会提升次版本号 `Y`。例如，从 `0.0.x` 到 `0.1.x` 可能包含破坏性变更。

如果你不希望引入破坏性变更，建议在项目中固定到 `0.0.x` 版本。

## 修订号（`Z`）

对于非破坏性变更，我们会递增 `Z`：

- Bug 修复
- 新功能
- 私有接口的变更
- beta 功能的更新

## 子包版本管理

主包 `@openai/agents` 由多个可独立使用的子包组成。目前这些包的版本是联动的，即一个包版本提升时，其他包也会随之提升。随着我们迈向 `1.0.0`，这一策略可能会有所调整。

## 更新日志

我们为每个子包生成更新日志，以帮助理解发生了哪些变更。由于变更可能发生在某个子包中，你可能需要查阅相应子包的更新日志以获取详情。

- [`@openai/agents`](https://github.com/openai/openai-agents-js/blob/main/packages/agents/CHANGELOG.md)
- [`@openai/agents-core`](https://github.com/openai/openai-agents-js/blob/main/packages/agents-core/CHANGELOG.md)
- [`@openai/agents-extensions`](https://github.com/openai/openai-agents-js/blob/main/packages/agents-extensions/CHANGELOG.md)
- [`@openai/agents-openai`](https://github.com/openai/openai-agents-js/blob/main/packages/agents-openai/CHANGELOG.md)
- [`@openai/agents-realtime`](https://github.com/openai/openai-agents-js/blob/main/packages/agents-realtime/CHANGELOG.md)
